Skip to content

ENT-8966: Replaced Jekyll with Hugo documentation builder #3448

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 27 commits into
base: master
Choose a base branch
from
Open

ENT-8966: Replaced Jekyll with Hugo documentation builder #3448

wants to merge 27 commits into from
+1,058 −9,335

Conversation

aleksandrychev
Copy link
Contributor

@aleksandrychev aleksandrychev commented May 29, 2025 •
edited
Loading

@aleksandrychev aleksandrychev added the WIP work in progress label May 29, 2025
@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/54/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-54/output/_site/

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/74/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-74/output/_site/

@aleksandrychev
Copy link
Contributor Author

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/91/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-91/output/_site/

@aleksandrychev aleksandrychev force-pushed the ENT-8966 branch 3 times, most recently from 29fb216 to 2a9843e Compare June 13, 2025 12:01
@aleksandrychev
Copy link
Contributor Author

Build Status

Documentation: https://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-94/output/_site/

@aleksandrychev aleksandrychev changed the title WIP: ENT-8966 ENT-8966: Replaced Jekyll with Hugo documentation builder Jun 13, 2025
@aleksandrychev aleksandrychev removed the WIP work in progress label Jun 13, 2025
@olehermanse
Copy link
Member

@cf-bottom please build this in Jenkins

@cf-bottom
Copy link

Alright, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/95/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-95/output/_site/

@aleksandrychev
Copy link
Contributor Author

cf-bottom didn't get NT_DOCS_REV, correct version to check is https://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-94/output/_site/. I will look how to fix it

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please, do not forget about nt-docs rev, I made changes to you recently and you should be aware about this. if not please do not trigger a job. thanks!

@cf-bottom
Copy link

Alright, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/96/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-96/output/_site/

@aleksandrychev
Copy link
Contributor Author

maybe cf-bottom didn't receive update yet... will check later
image

nickanderson
nickanderson approved these changes Jun 13, 2025
View reviewed changes
nickanderson
nickanderson requested changes Jun 13, 2025
View reviewed changes
Copy link
Member

@nickanderson nickanderson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The preview build doesn't load

@nickanderson
Copy link
Member

@cf-bottom jenkins please, do not forget about nt-docs rev, I made changes to you recently and you should be aware about this. if not please do not trigger a job. thanks!

@cf-bottom
Copy link

Alright, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/97/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-97/output/_site/

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/98/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-98/output/_site/

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/103/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-103/output/_site/

@aleksandrychev
Added search and versions pages
56c6833 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Removed unsuported {%raw%}
faa390b 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Adjusted pre-process and run scirpts
4230b0c 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Added redirect rules made to handle new documenation structure
83c10ec 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Removed unnessesary files from generator
9bd3465 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Removed Jekyl dependencies
f921f28 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Removed webpack and dependencies
a97ce9d 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Show versions list on the Versions page
f96f314 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Moved hugo install bits into shared scripts
bf4ebb2 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Added bump hugo version action
b407660 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Added hugo config, layouts and static files
0937387 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Added branch placeholder to the Hugo config and script that replaces it
bb0ac32 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Removed unsupported published frontmatter
386027a 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Get rid of try/except blocks from cfdoc preprocess
b88046b 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Get rid of generator/pages directory as we use hugo/content
c007e0f 
Signed-off-by: Ihor Aleksandrychiev <[email protected]>
@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/104/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-104/output/_site/

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins

@cf-bottom
Copy link

Sure, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/105/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-105/output/_site/

@aleksandrychev
Copy link
Contributor Author

@cf-bottom jenkins please

@cf-bottom
Copy link

Alright, I triggered a build:

Build Status

Jenkins: https://ci.cfengine.com/job/fast-build-and-deploy-docs-master/106/

Documentation: http://buildcache.cfengine.com/packages/build-documentation-pr/jenkins-fast-build-and-deploy-docs-master-106/output/_site/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@olehermanse olehermanse Awaiting requested review from olehermanse

@nickanderson nickanderson Awaiting requested review from nickanderson

@craigcomstock craigcomstock Awaiting requested review from craigcomstock

Requested changes must be addressed to merge this pull request.

Assignees
No one assigned
Labels
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
5 participants
@aleksandrychev @cf-bottom @olehermanse @nickanderson @craigcomstock